package com.water.note.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.water.note.entity.Wish;

import java.util.List;
import java.util.Map;

/**
 * 愿望清单Service接口
 */
public interface WishService extends IService<Wish> {

    /**
     * 分页查询愿望清单
     *
     * @param page     分页参数
     * @param userId   用户ID
     * @param status   状态
     * @param keyword  关键字
     * @return 分页结果
     */
    Page<Wish> page(Page<Wish> page, Long userId, Integer status, String keyword);
    
    /**
     * 更新愿望进度
     *
     * @param id       愿望ID
     * @param progress 进度
     * @return 是否成功
     */
    boolean updateProgress(Long id, Integer progress);
    
    /**
     * 更新愿望状态
     *
     * @param id     愿望ID
     * @param status 状态
     * @return 是否成功
     */
    boolean updateStatus(Long id, Integer status);
    
    /**
     * 获取愿望清单概览数据（总数和实现进度）
     *
     * @param userId 用户ID
     * @return 概览数据
     */
    Map<String, Object> getOverviewData(Long userId);
    
    /**
     * 获取最近的愿望清单
     *
     * @param userId 用户ID
     * @param limit 限制数量
     * @return 愿望清单列表
     */
    List<Wish> getRecentWishes(Long userId, int limit);
} 